home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 1.iso / dist / fw_bind.idb / usr / freeware / catman / a_man / cat8 / named.Z / named
Text File  |  2001-04-12  |  13KB  |  265 lines
  1.  
  2. @INDOT_U@NAMED(@SYS_OPS_EXT_U@)         LOCAL     @INDOT_U@NAMED(@SYS_OPS_EXT_U@)
  3.  
  4. NNAAMMEE
  5.      @@IINNDDOOTT@@nnaammeedd - Internet domain name server    (DNS)
  6.  
  7. SSYYNNOOPPSSIISS
  8.      @@IINNDDOOTT@@NNAAMMEEDD [--dd _d_e_b_u_g_l_e_v_e_l] [--pp _p_o_r_t_#] [--(bb|cc) _c_o_n_f_i_g___f_i_l_e] [--ff --qq --rr
  9.           --vv] [--uu _u_s_e_r___n_a_m_e] [--gg _g_r_o_u_p___n_a_m_e] [--tt _d_i_r_e_c_t_o_r_y] [--ww
  10.           _d_i_r_e_c_t_o_r_y] [_c_o_n_f_i_g___f_i_l_e]
  11.  
  12. DDEESSCCRRIIPPTTIIOONN
  13.      NNaammeedd is the Internet domain name server.    See RFC's 1033,    1034, and 1035
  14.      for more information on the Internet name-domain system.  Without any ar
  15.      guments, nnaammeedd will read the default configuration    file _/_e_t_c_/_n_a_m_e_d_._c_o_n_f,
  16.      read any initial data, and    listen for queries.  A _c_o_n_f_i_g___f_i_l_e argument
  17.      given at the end of the command line will override    any _c_o_n_f_i_g___f_i_l_e    speci
  18.      fied by using the ``--bb'' or ``--cc''    flags.
  19.  
  20.      NNOOTTEE:: Several of nnaammeedd's options, and much    more of    its behaviour, can be
  21.      controlled    in the configuration file.  Please refer to the    configuration
  22.      file guide    included with this BBIINNDD    distribution for further information.
  23.  
  24.      Options are:
  25.  
  26.      --dd    _d_e_b_u_g_l_e_v_e_l
  27.          Print debugging information.  The _d_e_b_u_g_l_e_v_e_l is a number de
  28.          termines the level of messages    printed.  If negative,
  29.          _d_e_b_u_g_l_e_v_e_l is set to ``1''.
  30.  
  31.          NNOOTTEE:: The new debugging framework is considerably more    so
  32.          phisticated than it was in older versions of @@IINNDDOOTT@@NNAAMMEEDD.
  33.          The configuration file's ``logging'' statement    allows for
  34.          multiple, distinct levels of debugging    for each of a large
  35.          set of    categories of events (such as queries, transfers in or
  36.          out, etc.).  Please refer to the configuration    file guide in
  37.          cluded    with this BBIINNDD distribution for    further    information
  38.          about these extensive new capabilities.
  39.  
  40.      --pp    _p_o_r_t_#     Use the specified remote port number; this is the port    number
  41.          to which @@IINNDDOOTT@@NNAAMMEEDD will send queries.  The default value
  42.          is the    standard port number, i.e., the    port number returned
  43.          by getservbyname(@LIB_NETWORK_EXT@) for service ``domain''.
  44.  
  45.          NNOOTTEE:: Previously, the syntax ``--pp _p_o_r_t_#[_/_l_o_c_a_l_p_o_r_t_#]''    was
  46.          supported; the    first port was that used when contacting
  47.          _r_e_m_o_t_e    servers, and the second    one was    the service port bound
  48.          by the    _l_o_c_a_l instance of @@IINNDDOOTT__UU@@NNAAMMEEDD. The current usage is
  49.          equivalent to the old usage without the _l_o_c_a_l_p_o_r_t_# specified;
  50.          this functionality can    be specified with the ``listen-on''
  51.          clause    of the configuration file's ``options''    statement.
  52.  
  53.      --(bb|cc) _c_o_n_f_i_g___f_i_l_e
  54.          Use an    alternate _c_o_n_f_i_g___f_i_l_e; this argument is    overridden by
  55.          any _c_o_n_f_i_g___f_i_l_e which is specified at the end of the command
  56.          line.    The default value is _/_e_t_c_/_n_a_m_e_d_._c_o_n_f.
  57.  
  58.      --ff         Run this process in the foreground; don't fork(@SYSCALL_EXT@)
  59.          and daemonize.     (The default is to daemonize.)
  60.  
  61.      --qq         Trace all incoming queries if @@IINNDDOOTT__UU@@NNAAMMEEDD has been com
  62.          piled with QRYLOG defined.
  63.  
  64.          NNOOTTEE:: This option is deprecated in favor of the ``queries''
  65.          _l_o_g_g_i_n_g _c_a_t_e_g_o_r_y of the configuration file's ``logging''
  66.          statement; for    more information, please refer to the configu
  67.          ration    file guide included with this distribution of BBIINNDD.
  68.  
  69.      --rr         Turns recursion off in    the server.  Answers can come only
  70.          from local (primary or    secondary) zones.  This    can be used on
  71.          root servers.    The default is to use recursion.
  72.  
  73.          NNOOTTEE:: This option can be overridden by    and is deprecated in
  74.          favor of the ``recursion'' clause of the configuration    file's
  75.          ``options'' statement.
  76.  
  77.      --vv         Report    the version and    exit.
  78.  
  79.      --uu    _u_s_e_r___n_a_m_e
  80.          Specifies the user the    server should run as after it initial
  81.          izes.    The value specified may    be either a username or    a nu
  82.          meric user id.     If the    ``--gg'' flag is not specified, then the
  83.          group id used will be the primary group of the    user specified
  84.          (initgroups() is called, so all of the    user's groups will be
  85.          available to the server).
  86.  
  87.      --gg    _g_r_o_u_p___n_a_m_e
  88.          Specifies the group the server    should run as after it ini
  89.          tializes.  The    value specified    may be either a    groupname or a
  90.          numeric group id.
  91.  
  92.      --tt    _d_i_r_e_c_t_o_r_y
  93.          Specifies the directory the server should chroot() into as
  94.          soon as it is finshed processing command line arguments.
  95.  
  96.      --ww    _d_i_r_e_c_t_o_r_y
  97.          Sets the working directory of the server.  The    ``directory''
  98.          clause    of the configuration file's ``options''    statement
  99.          overrides any value specified on the command line.  The de
  100.          fault working directory is the    current    directory (``.'').
  101.  
  102.      Any additional argument is    taken as the name of the configuration file,
  103.      for compatibility with older implementations; as noted above, this    argu
  104.      ment overrides any    _c_o_n_f_i_g___f_i_l_e specified by the use of the    ``--bb'' or
  105.      ``--cc'' flags.  If no further argument is given, then the default configu
  106.      ration file is used (_/_e_t_c_/_n_a_m_e_d_._c_o_n_f).
  107.  
  108.    MMaasstteerr FFiillee FFoorrmmaatt
  109.      The master    file consists of control information and a list    of resource
  110.      records for objects in the    zone of    the forms:
  111.  
  112.        $INCLUDE <filename> <opt_domain>
  113.        $ORIGIN <domain>
  114.        $TTL    <ttl>
  115.        <domain> <opt_ttl> <opt_class> <type> <resource_record_data>
  116.  
  117.      where:
  118.  
  119.      _d_o_m_a_i_n       is ``.'' for    root, ``@'' for    the current origin, or a stan
  120.            dard    domain name. If    _d_o_m_a_i_n is a standard domain name that
  121.            does    _n_o_t end    with ``.'', the    current    origin is appended to
  122.            the domain. Domain names ending with    ``.'' are unmodified.
  123.  
  124.      _o_p_t___d_o_m_a_i_n       This    field is used to define    an origin for the data in an
  125.            included file.  It is equivalent to placing an $ORIGIN
  126.            statement before the    first line of the included file.  The
  127.            field is optional.  Neither the _o_p_t___d_o_m_a_i_n field nor
  128.            $ORIGIN statements in the included file modify the current
  129.            origin for this file.
  130.  
  131.      _t_t_l       A integer number that sets the default time-to-live for fu
  132.  
  133.            ture    records    without    an explicit ttl.
  134.  
  135.      _o_p_t___t_t_l       An optional integer number for the time-to-live field.  If
  136.            not set the ttl is taken from the last $TTL statement.  If
  137.            no $TTL statement has occured then the SOA minimum value is
  138.            used    and a warning is generated.
  139.  
  140.      _o_p_t___c_l_a_s_s       The object address type; currently only one type is sup
  141.            ported, IN, for objects connected to    the DARPA Internet.
  142.  
  143.      _t_y_p_e       This    field contains one of the following tokens; the    data
  144.            expected in the _r_e_s_o_u_r_c_e___r_e_c_o_r_d___d_a_t_a    field is in parenthe
  145.            ses:
  146.  
  147.              A        a host address (dotted-quad    IP address)
  148.  
  149.              NS        an authoritative name server (domain)
  150.  
  151.              MX        a mail exchanger (domain), preceded    by a
  152.                     preference value (0..32767), with lower
  153.                     numeric values representing    higher logical
  154.                     preferences.
  155.  
  156.              CNAME        the    canonical name for an alias (domain)
  157.  
  158.              SOA        marks the start of a zone of authority
  159.                     (domain of originating host, domain    ad
  160.                     dress of maintainer, a serial number and
  161.                     the    following parameters in    seconds: re
  162.                     fresh, retry, expire and minimum TTL (see
  163.                     RFC    883 and    RFC 2308)).
  164.  
  165.              NULL        a null resource record (no format or data)
  166.  
  167.              RP        a Responsible Person for some domain name
  168.                     (mailbox, TXT-referral)
  169.  
  170.              PTR        a domain name pointer (domain)
  171.  
  172.              HINFO        host information (cpu_type OS_type)
  173.  
  174.      Resource records normally end at the end of a line, but may be continued
  175.      across lines between opening and closing parentheses.  Comments are in
  176.      troduced by semicolons and    continue to the    end of the line.
  177.  
  178.      NNOOTTEE:: There are other resource record types not shown here.  You should
  179.      consult the BBIINNDD Operations Guide (``BOG'') for the complete list.     Some
  180.      resource record types may have been standardized in newer RFC's but not
  181.      yet implemented in    this version of    BBIINNDD.
  182.  
  183.    SSOOAA RReeccoorrdd FFoorrmmaatt
  184.      Each master zone file should begin    with an    SOA record for the zone.  An
  185.      example SOA record    is as follows:
  186.  
  187.      @         IN         SOA     ucbvax.Berkeley.EDU. rwh.ucbvax.Berkeley.EDU. (
  188.                      1989020501         ; serial
  189.                      10800   ; refresh
  190.                      3600    ; retry
  191.                      3600000 ; expire
  192.                      86400 ) ; minimum
  193.  
  194.      The SOA specifies a serial    number,    which should be    incremented each time
  195.      the master    file is    changed.  Note that the    serial number can be given as
  196.      a dotted number, but this is a _v_e_r_y unwise    thing to do since the transla
  197.      tion to normal integers is    via concatenation rather than multiplication
  198.      and addition.  You    can spell out the year,    month, day of month, and 0..99
  199.      version number and    still fit inside the unsigned 32-bit size of this
  200.      field.  (It's true    that we    will have to rethink this strategy in the year
  201.      4294, but we're not worried about it.)
  202.  
  203.      Secondary servers check the serial    number at intervals specified by the
  204.      refresh time in seconds; if the serial number changes, a zone transfer
  205.      will be done to load the new data.     If a master server cannot be contact
  206.      ed    when a refresh is due, the retry time specifies    the interval at    which
  207.      refreshes should be attempted.  If    a master server    cannot be contacted
  208.      within the    interval given by the expire time, all data from the zone is
  209.      discarded by secondary servers.  The minimum value    is the cache time-to-
  210.      live for negative answers (RFC 2308).
  211.  
  212. NNOOTTEESS
  213.      The boot file directives ``domain'' and ``suffixes'' have been obsoleted
  214.      by    a more useful, resolver-based implementation of    suffixing for partial
  215.      ly-qualified domain names.     The prior mechanisms could fail under a num
  216.      ber of situations,    especially when    then local nameserver did not have
  217.      complete information.
  218.  
  219.      The following signals have    the specified effect when sent to the server
  220.      process using the kill(@CMD_EXT@) command:
  221.  
  222.      SIGHUP    Causes server to    read _n_a_m_e_d_._c_o_n_f    and reload the database.  If
  223.            the server is built with    the FORCED_RELOAD compile-time option,
  224.            then SIGHUP will    also cause the server to check the serial num
  225.            ber on all secondary zones; normally, the serial    numbers    are
  226.            only checked at the SOA-specified intervals.
  227.  
  228.      SIGINT    Dumps the current data base and cache to
  229.            ``_/_v_a_r_/_t_m_p_/_n_a_m_e_d___d_u_m_p_._d_b'' or the value of _PATH_DUMPFILE.
  230.  
  231.      SIGILL    Dumps statistics    data into _n_a_m_e_d_._s_t_a_t_s if the server is com
  232.            piled with -DSTATS. Statistics data is appended to the file.
  233.  
  234.      SIGSYS    Dumps the profiling data    in _/_v_a_r_/_t_m_p if the server is compiled
  235.            with profiling (server forks, chdirs and    exits).
  236.  
  237.      SIGTERM   Saves any modified dynamic zones    to the file system, and    shuts
  238.            down the    server.
  239.  
  240.      SIGUSR1   Turns on    debugging; each    SIGUSR1    increments debug level.
  241.            (SIGEMTon older systems without SIGUSR1.)
  242.  
  243.      SIGUSR2   Turns off debugging completely.     (SIGFPEon older systems
  244.            without SIGUSR2.)
  245.  
  246.      SIGWINCH  Toggles logging of all incoming queries via sys
  247.            log(@SYS_OPS_EXT@) (requires server to have been    built with the
  248.            QRYLOG option).
  249.  
  250. FFIILLEESS
  251.      /etc/named.conf                 default name server configu
  252.                          ration    file
  253.      /var/run/named.pid    (_PATH_PIDFILE)         the process id
  254.      /var/tmp/named_dump.db (_PATH_DUMPFILE)     dump of the name server
  255.                          database
  256.      /var/tmp/named.run    (file: _PATH_DEBUG)     debug output
  257.      /var/tmp/named.stats (file: _PATH_STATS)     nameserver statistics data
  258.  
  259. SSEEEE AALLSSOO
  260.      gethostbyname(@LIB_NETWORK_EXT@),    hostname(@DESC_EXT@),
  261.      kill(@CMD_EXT@),  resolver(@LIB_NETWORK_EXT@),  resolver(@FORMAT_EXT@),
  262.      signal(@SYSCALL_EXT@),  RFC 882, RFC 883, RFC 973,    RFC 974, RFC 1033, RFC
  263.      1034, RFC 1035, RFC 1123, RFC 2308    ``Name Server Operations Guide for
  264.      BBIINNDD''
  265.